<?php
namespace ImWorker;

/**
 * ImWorker 统计管理 (jobs processed, failed, etc)
 *
 * @package        ImWorker/Stat
 */
class Stat
{
    /**
     * 获取指定统计所提供的统计计数器的值。
     *
     * @param string $stat 统计的名称来获取的统计数据。
     * @return mixed 统计值
     */
    public static function get($stat)
    {
        return (int) ImEqueue::redis()->get('stat:' . $stat);
    }

    /**
     * 通过一定量的递增指定统计值（默认值为1 ）
     *
     * @param string $stat 统计信息的名称递增
     * @param int $by 量递增的统计信息。
     * @return boolean True if successful, false if not.
     */
    public static function incr($stat, $by = 1)
    {
        return (bool) ImEqueue::redis()->incrby('stat:' . $stat, $by);
    }

    /**
     * 通过一定量递减指定统计值（默认值为1 ）
     *
     * @param string $stat The name of the statistic to decrement.
     * @param int $by The amount to decrement the statistic by.
     * @return boolean True if successful, false if not.
     */
    public static function decr($stat, $by = 1)
    {
        return (bool) ImEqueue::redis()->decrby('stat:' . $stat, $by);
    }

    /**
     * 删除与给定名称的统计数据。
     *
     * @param string $stat The name of the statistic to delete.
     * @return boolean True if successful, false if not.
     */
    public static function clear($stat)
    {
        return (bool) ImEqueue::redis()->del('stat:' . $stat);
    }
}
